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INTRODUCTION 

Option 1 firmware Version 8 adds a 451 OA driver to the 
Option 10 3PPI interface. This driver allows connection of a 
451 OA Color Graphic Rasterizer to a 3 Peripheral Port 
Interface. The 451 OA accepts 4100-style graphics 
commands and drives a color copier. 

This addendum documents the new, changed, and 
Incompatible commands that are effected by the new driver. 
It should be used in conjunction with the operators manual, 
the 4110/4120 Series Command Reference Manual , and the 
4110/4120 Series Host Programmers Manual 
accompanying your terminal. 



THE 4510 DRIVER 

When the 4510 driver Is assigned to a peripheral port, 
graphics area copies are initiated with the PLOT or SAVE 
commands. Copies from another source are initiated with 
the COPY or SPOOL commands. You may also send 
directory information to the 451 OA with the DIRECTORY 
command; however, Tektronix cautions you about using this 
command for this reason: 

The DIRECTORY command issues a ^r as the text line 
terminator and the 451 OA, by default, does not add a ^ 
when it receives a ^r. Therefore, all directory text will be 
printed as a single line, unless the 451 OA is first set to ^r 
implies "-f. 



FIRMWARE VERSION 8 CHANGES 

Firmware Version 8 does not change any of the Version 7 
drivers. Enhancements in Version 8 include: 

• 451 OA device assignment to any of the peripheral ports 
with the PORT-ASSIGN command. 

• Five new commands are added to support 451 OA. 

• SEG: -6 is added to the SAVE command so that all 
segments visible in all views can be saved. 



41 10/4120 SERIES FEATURES 
NOT SUPPORTED 

The following 41 10/4120 Series features are not supported 
by either the 451 OA or the Version 8 firmware: 

• 3D 

• Non-retained segments with PLOT and SAVE 

• Dialog areas 

• Pixel operations 

• Background indices 

• Segment writing modes AND, OR, and XOR 

• Panel fill modes 

• Multiple surfaces (surface priority is ignored and the 
Super Surface color map cannot be sent because you 
cannot Inquire the Super Surface color map) 

• Grey levels 

• User defined fill patterns (the 451 OA emulates 41 07/41 09 
dithered fill patterns 50 through 1 74) 

• Alpha text is converted to string precision graphtext and 
is then subject to transforms 
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DATA PASSED TO 451 OA 



NEW AND MODIFIED COMMANDS 



The following is a list of the data passed to the 451 OA with 
each COPY, SPOOL, SAVE, DIR, or PLOT command: 

LOAD(^cJL) 

SET-QUEUE-SIZE (^cNQ) 
SET-DEVICE-ASPECT-RATIO fcQJ) — 

set aspect ratio to 5:4 
PAGEfc'^F) 

SET-COLOR-COPIER-REPAINT) f cQT) 
SET-IMAGE-ORIENTATION f cQO) 
SET-COLOR-MODE (^cTM) — 

sets RGB, opaque, normal operation 
SET-SURFACE-COLOR-MAP (^cTG) 
SET-VIEW-ATTRIBUTES (^cRA) 
loop_another viewjn stream: 

EcUX, ^cRA, ^cRV, ^cRW 
from the file stream if at start 

SET-NUMBER-OF-COPIES (^cQN) 

PAGE(Ecf^F) 

SET-BORDER-VISIBILITY (^cRE) — 
data from last ^cRE in file stream 

>>>>>>> > data stream until ^cRAthen 

loop another view in stream 

HARDCOPY f cKHO) or (^cKH2) depending 
on PINVERSION parameter 

This data changes 451 OA settings. If you do not want 451 OA 
settings changed to the current terminal settings for these 
commands, use the PPORT driver instead of the 451 
driver. For example, if you issue the command COPY HO: 
TO PO:, the 451 OA color map will be changed to the current 
terminal color map which may or may not be the color map 
included in the file on HO:. Unexpected results are likely 

Segment definitions are sent without modification; however, 
the following commands are ignored by the 451 OA: 

SET-SEGMENT-WRITING-MODE 

SET-SEGMENT-HIGHLIGHTING 

SET-SEGMENT-DETECTABILITY 

SET-SEGMENT-DISPLAY-PRIORITY 

SET-SEGMENT-CLASS 

SET-BACKGROUND-INDICES 

SET-PANEL-FILLING-MODE 

SET-PICK-ID 

The CALL-SEGMENT and 

SET-SEGMENT-SCALE-ROTATION commands are also not 
recognized by the 451 OA and are not sent when SAVE SEG 
-4, SAVE SEG -6, or PLOT commands are issued. 



The two existing 41 1 0/41 20 Series commands modified by 
firmware Version 8 are: 

• PORT-ASSIGN 

• SAVE 

The five new commands added by firmware Version 8 are: 

• SET-PORT-BLACK-WHITE-INVERSION 

• SET-PORT-COLOR-COPIER-REPAINT 

• SET-PORT-IMAGE-ORIENTATION 

• SET-PORT-NUMBER-OF-COPIES 

• SET-PORT-QUEUE-SIZE 

These commands are described in the following 
paragraphs. Only the changes are described for the two 
modified commands. The commands are described 
alphabetically 
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PORT-ASSIGN Command 



SAVE Command 



Another protocol-identifier (4510) has been added to this 
command to allow interface to the 4510. The new parameter 
Is described in Table 1 . 



Host Syntax 



^cPA 6ev\ce:port s\x\nq\protocol-identifler 



The argument -6 is added to item-number parameter when 
use6 \n\\\\ item-type SEGi. 

Host Syntax 



^c J V stri ng : item-type \ nV.item-number 
string: separator dev\ce:destination 



Setup Syntax 



PASSIGN ®p port protocol-identifier 



Setup Syntax 



SAVE^p item-type item-number 
TO destination 



PARAMETERS 

protocol-identifier 

A string specifying the protocol being assigned to the 
peripheral port. Valid values are: 

PPORT 

4510 

4643 

4662 

4662/MP 

4662/NT 

4663 

4663/NT 

4663/NB 

4957 

4957/S 

4958 

4958/S 

KANA 

DMA (41 1 1 PO: only) 



Table 1 
THE 451 OA PERIPHERAL PORT PROTOCOL IDENTIFIER 



Protocol Identifier 


Meaning 


451 OA 


(451 OA Rasterizer). Assigns a protocol for 
data output to the 451 OA Rasterizer. 



PARAMETERS 

item-number 

The macro or segment or number of pixels to be saved. 
Valid values depend on item-type: 

for MAC, all values valid for DEFINE-MACRO (-1 

means all) 
for SEG, ~6, -4, -3, -1 , and 1 to 32767 
for RAS and RUN, -2 to 32767 

DESCRIPTION 

Segment -6 means "all segments visible in all views" 
analogous to and in the same order as RENEW-VIEW all. 
Segment -6 can be thought of as multiple PLOT commands 
within one save sequence. For segment number -4 and -6, 
all calls to segments are expanded into their primitives; all 
other item-numbers only save the calls, not the called 
segment. 

For each view saved, the following commands are sent to 
the destination device: 

• For segment -4 and -6 WINDOW and VIEWPORT 
commands, specifying the current view's window and 
viewport. 
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SET-PORT-BLACK-WHITE-INVERSION 
Command 

This is a new command that selects how pure black and 
pure white are printed when using the 451 driver. 

Host Syntax 



"^cPJ string: por/ mtimage-polarity 



DESCRIPTION 

This command Instructs the 451 OA Color Graphic 
Rasterizer to reverse the black and white colors when 
processing hard copies. The image-polarity parameter 
determines whether an image's blacks and whites are 
reversed. 

The port that you specify in this command must have the 
41 50 device protocol assigned to it (PORT-ASSIGN 
command); otherwise, the command parameters are 
ignored. 



Setup Syntax 



PINVERSION Sp port image-polarity 



PARAMETERS 



port 



Specifies the RS-232 peripheral port to which an image 
polarity is being assigned. Valid ports are: 



PO 
P1 
P2 



(411 5/41 20 Series only) 



image-polarity 

NEGATIVE; reverse black and white 

1 POSITIVE; don't reverse black and white 



DEFAULTS 

port 

as shipped -— none 

on power-up ■— remembered 

if omitted — error PJ 11 

image-polarity 
as shipped — 
on power-up — remembered 
if omitted — 



ERRORS 

PJ 11 (Level 2): 
PJ12(Level3): 
PJ21 (Level 2): 



Invalid Port Specifier. 

Out of memory while parsing. 

Invalid Image-Polarity 



REFERENCES 

PLOT Command 
PORT-ASSIGN Command 
SAVE Command 



INQUIRY COMMAND 

REPORT-PORT-STATUS command 
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SET-PORT-COLOR-COPIER-REPAINT 
Command 

This new command allows multiple passes on a 4692 copier 
without changing media and is intended to be used with 
transparent media. It is used only with the 4510 driver. 

Host Syntax 



^cPT string: port \nX:repaint-count 



Setup Syntax 



PREPAINT ®p port repaint-count 



PARAMETERS 



port 



Specifies the RS-232 peripheral port to which a repaint 
count is being assigned. Valid ports are: 



DESCRIPTION 

This command specifies how many print passes are made 
by the 4692 Color Copier via the 451 OA Color Graphic 
Rasterizer. Painting the image several times concentrates 
ink more heavily on the copy This is useful for preparing 
transparencies because it results In brighter colors. 

The time required to make a copy will be multiplied by the 
number of image passes used. For the fastest copy time, 
use a repaint count of 1 . The setting has no time effect on 
the terminal unless more copies are transmitted after the 
rasterizer queue is full. 

This command has no effect on copies made to the 4691 or 
4695. 



DEFAULTS 

port 

as shipped — none 

on power-up -- remembered 

if omitted — error PT1 1 

repaint-count 
as shipped ■— 1 
on power-up — remembered 
if omitted — 1 



PO: 
P1: 

P2: (41 15/41 20 Series only) 

repaint-count (0 to 4) . 

Specifies the number of times the image is transferred to 
the copier (0 has the same effect as 1). 



ERRORS 

PT1 1 ( Level 2): 
PT12(Level3): 
PT21 (Level 2): 



Invalid port. 

Out of memory while parsing. 

Invalid repaint-count. 



REFERENCES 

PLOT Command 
PORT-ASSIGN Command 
SAVE Command 



INQUIRY COMMAND 

REPORT-PORT-STATUS command 
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SET^PORPIMAGE-ORIENTATION 
Command 

This new command determines where the long axis of the 
image will be on the copy media. It is used only with the 
4510 driver. 



DESCRIPTION 

The SET-PORT-IMAGE-ORIENTATION command sets the 
orientation of the hardcopy image with respect to the 
hardcopy media (the paper or transparency on the hardcopy 
machine) on the copier connected to the rasterizer. 



Host Syntax 




DEFAULTS 

port 

as shipped — none 

on power-up — remembered 

if omitted — error P011 



Setup Syntax 



PORIENT^p port orientation 



PARAMETERS 



port 



Specifies the RS-232 peripheral port to which an 
orientation is being assigned. Valid ports are: 



PO 
P1 

P2; 



(41 15/41 20 Series only) 



orientation (0 to 3) 

Selects the orientation of the hardcopy image with 
respect to the hardcopy media. Setup mode parameters 
are H0R8Z0NTAL, VBOTTOM, VCENTER, and VTOP. 

HORIZONTAL: long axis of image on long axis 
of media 

1 VBOTTOM: long axis of image on short axis of 
media, at bottom 

2 VCENTER: long axis of image on short axis of 
media, centered 

3 VTOP: long axis of image on short axis of 
media, at top 



orientation 

as shipped — 

on power-up — remembered 

if omitted ~0 



ERRORS 

P0l1(Level2): 
P012(Level3): 
P021 (Level 2): 



Invalid Port Specifier. 

Out of memory while parsing. 

Invalid orientation. 



REFERENCES 

PLOT Command 
PORT-ASSIGN Command 
SAVE Command 



INQUIRY COMMAND 

REPORT-PORT-STATUS command 
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SET-PORT-NUMBER-OF-COPIES 
Command 

This new command allows multiple copies of the same 
image without retransmitting data. It is used only with the 
4510 driver. 

Host Syntax 



^cPN \nX:port \r\X\number-of-copies 



Setup Syntax 



HCCOPIES ^p port number-of-copies 



PARAMETERS 



port 



Specifies the RS-232 peripheral port to which a number 
of copies is being assigned. Valid ports are: 

PO: 
P1: 

P2: (41 15/41 20 Series only) 

number-of-copies (0 to 64) 

Selects the number of copies that are produced when a 
color hardcopy operation is invoked (0 has the same 
effect as 1). 



DESCRIPTION 

The SET-PORT-NUMBER-OF-COPIES command sets the 
number of copies that the rasterizer will make at the end of a 
PLOT command. 



DEFAULTS 

port 

as shipped — none 

on power-up — remembered 

if omitted — error PN11 

number-of-copies 
as shipped — ■ 
on power-up -— 
if omitted — 



ERRORS 

PN11(Level2): 
PNl2(Level3): 
PN21 (Level 2): 



Invalid Port Specifier. 

Out of memory while parsing. 

Invalid Number-Of-Copies. 



REFERENCES 

PLOT Command 
PORT-ASSIGN Command 
SAVE Command 



INQUIRY COMMAND 

REPORT-PORT-STATUS command 
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SET-PORT-QUEUE-SIZE Command 



DESCRIPTION 



This command allows the size of the 451 OA communication 
queue when the 4510 driver is selected. 

Host Syntax 



^cPS \nt:port mtqueue-size 



This command selects the number of bytes the 451 OA will ^ 
set aside from its memory for the communications input 
queue storage area. 

This can be used to queue multiple PLOTs in the 451 OA, 
without holding up the terminal until each copy is 
completed. 



DEFAULTS 



Setup Syntax 



PQUEUE ^p port queue-size 



PARAMETERS 



port 

as shipped — none 

on power-up — remembered 

if omitted — error PS11 

queue-size 

as shipped — 

on power-up — 1000 

if omitted — 



port 



Specifies the RS-232 peripheral port to which a queue 
size is being assigned. Valid ports are: 



PO 
P1 

P2; 



(41 15/41 20 Series only) 



queue-size {0 to 2^y-i) 

Number of bytes reserved for the 451 OA's 
communications input queue. (The 451 OA will not lower 
the queue below 1000). 



ERRORS 

RS1 1 (Level 2): Invalid Port Specifier. 

PS1 2 (Level 3): Out of memory while parsing. 

TS21 (Level 2): Invalid queue-size. 



REFERENCES 

PLOT Command 
PORT-ASSIGN Command 
SAVE Command 



INQUIRY COMMAND 

REPORT-PORT-STATUS command 
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